home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
X11
/
xmessage.z
/
xmessage
Wrap
Text File
|
1998-10-30
|
9KB
|
199 lines
XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111)))) XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
NNNNAAAAMMMMEEEE
xmessage - display a message or query in a window (X-based
/bin/echo)
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxmmmmeeeessssssssaaaaggggeeee [ ----bbbbuuuuttttttttoooonnnnssss _l_a_b_e_l_1[:_v_a_l_u_e_1],,,,_l_a_b_e_l_2[:_v_a_l_u_e_2],,,,... ] [
_o_p_t_i_o_n_s ] ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
xxxxmmmmeeeessssssssaaaaggggeeee [ ----bbbbuuuuttttttttoooonnnnssss _l_a_b_e_l_1[:_v_a_l_u_e_1],,,,_l_a_b_e_l_2[:_v_a_l_u_e_2],,,,... ] [
_o_p_t_i_o_n_s ] _m_e_s_s_a_g_e ...
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_X_m_e_s_s_a_g_e displays a window containing a message from the
command line, a file, or standard input. Along the lower
edge of the message is row of buttons; clicking the left
mouse button on any of these buttons will cause _x_m_e_s_s_a_g_e to
exit. Which button was pressed is returned in the exit
status and, optionally, by writing the label of the button
to standard output.
_X_m_e_s_s_a_g_e is typically used by shell scripts to display
information to the user or to ask the user to make a choice.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
These are the command line options that _x_m_e_s_s_a_g_e
understands.
----bbbbuuuuttttttttoooonnnnssss _b_u_t_t_o_n,_b_u_t_t_o_n,...
This option will cause _x_m_e_s_s_a_g_e to create one button
for each comma-separated _b_u_t_t_o_n argument. The
corresponding resource is bbbbuuuuttttttttoooonnnnssss. Each _b_u_t_t_o_n
consists of a label optionally followed by a colon
and an exit value. The label is the name of the
Command button widget created and will be the
default text displayed to the user. Since this is
the name of the widget it may be used to change any
of the resources associated with that button. The
exit value will be returned by _x_m_e_s_s_a_g_e if that
button is selected. The default exit value is 100
plus the button number. Buttons are numbered from
the left starting with one. The default string if
no ----bbbbuuuuttttttttoooonnnnssss option is given is ooookkkkaaaayyyy::::0000.
----ddddeeeeffffaaaauuuulllltttt _l_a_b_e_l
Defines the button with a matching _l_a_b_e_l to be the
default. If not specified there is no default. The
corresponding resource is ddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn. Pressing
Return anywhere in the _x_m_e_s_s_a_g_e window will activate
the default button. The default button has a wider
border than the others.
----ffffiiiilllleeee _f_i_l_e_n_a_m_e
File to display. The corresponding resource is
Page 1 (printed 4/30/98)
XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111)))) XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
ffffiiiilllleeee. A _f_i_l_e_n_a_m_e of `----' reads from standard input.
If this option is not supplied, _x_m_e_s_s_a_g_e will
display all non-option arguments in the style of
_e_c_h_o. Either ----ffffiiiilllleeee or a message on the command line
should be provided, but not both.
----pppprrrriiiinnnntttt This will cause the program to print the label of
the button pressed to standard output. Equivalent
to setting the pppprrrriiiinnnnttttVVVVaaaalllluuuueeee resource to TRUE. This is
one way to get feedback as to which button was
pressed.
WWWWIIIIDDDDGGGGEEEETTTT HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
Knowing the name and position in the hierarchy of each
widget is useful when specifying resources for them. In the
chart below, the class and name of each widget is given.
Xmessage (xmessage)
Form form
Label message
Command (label1)
Command (label2)
.
.
.
RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
_X_m_e_s_s_a_g_e has a few top-level application resources that
allow customizations that are specific to _x_m_e_s_s_a_g_e.
ffffiiiilllleeee A String resource specifying the file to display.
bbbbuuuuttttttttoooonnnnssss A String resource specifying the buttons to display.
See the ----bbbbuuuuttttttttoooonnnnssss command-line option.
ddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn
A String resource specifying a default button by
label.
pppprrrriiiinnnnttttVVVVaaaalllluuuueeee
A Boolean resource that determines whether or not
the label of the button pressed to exit the program
is printed. The default is FALSE.
AAAACCCCTTTTIIIIOOOONNNNSSSS
eeeexxxxiiiitttt((((_v_a_l_u_e))))
exit immediately with an exit status of _v_a_l_u_e
(default 0). This action can be used with
translations to provide alternate ways of exiting
_x_m_e_s_s_a_g_e.
ddddeeeeffffaaaauuuulllltttt----eeeexxxxiiiitttt(((())))
Page 2 (printed 4/30/98)
XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111)))) XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
exit immediately with the exit status specified by
the default button. If there is no default button,
this action has no effect.
EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
If it detects an error, _x_m_e_s_s_a_g_e returns 1, so this value
should not be used with a button.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
_X(1), _e_c_h_o(1), _c_a_t(1)
CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
Copyright 1988,1991 Massachusetts Institute of Technology.
See _X(1) for a full statement of rights and permissions.
AAAAUUUUTTTTHHHHOOOORRRRSSSS
Chris Peterson, MIT Project Athena
Stephen Gildea, MIT X Consortium
Page 3 (printed 4/30/98)